---

Road Map to QuickTime 4

The Standard Image-Compression Dialog Component

This chapter describes the standard image-compression dialog component. The image-compression dialog provides a user interface for setting the compression parameters of still images and sequences. If your application creates movies, you should read about the image-compression dialog component. This chapter also contains a section describing how to create your own dialog component, although most developers will not need to do this.

About Standard Image-Compression Dialog Components

Inside Macintosh introduces the standard image-compression dialog component and illustrates the two standard dialog boxes.

Using Standard Image-Compression Dialog Components

Inside Macintosh describes how and when to use the dialog component, and provides details, including sample code, for the following procedures:

• Opening a Connection to a Standard Image-Compression Dialog Component
• Displaying the Dialog Box to the User
• Extending the Basic Dialog Box

Creating a Standard Image-Compression Dialog Component

Inside Macintosh describes the component type for a compressor dialog component, and defines the constants used for request codes. Developers planning to create a dialog component should read this section.

Standard Image-Compression Dialog Component Functions

Inside Macintosh defines the functions that you can use to work with Standard Image-Compression Dialog Components. The functions are divided into groups that serve a common purpose:

• Getting Default Settings for an Image or a Sequence
• SCDefaultPixMapSettings
• SCDefaultPictHandleSettings
• SCDefaultPictFileSettings
• Displaying the Standard Image-Compression Dialog Box
• SCRequestImageSettings
• SCRequestSequenceSettings
• Compressing Still Images
• SCCompressImage
• SCCompressPicture
• SCCompressPictureFile
• Compressing Image Sequences
• SCCompressSequenceBegin
• SCCompressSequenceFrame
• SCCompressSequenceEnd
• Working With Image or Sequence Settings
• SCGetInfo
• SCSetInfo
• Specifying a Test Image
• SCSetTestImagePictHandle
• SCSetTestImagePictFile
• SCSetTestImagePixMap
• Positioning Dialog Boxes and Rectangles
• SCPositionRect
• SCPositionDialog
• SCGetBestDeviceRect
• Utility Function
• SCNewGWorld
• Application-Defined Function
• MyHook

Request Types

Inside Macintosh describes the request types used by the dialog component functions SCGetInfo and SCSetInfo . You will use these request types to get and set compression parameters for images and sequences. There are several request types, each using different parameter data:

• The Spatial Settings Request Type
• The Temporal Settings Request Type
• The Data-Rate Settings Request Type
• The Color Table Settings Request Type
• The Progress Function Request Type
• The Extended Functions Request Type
• The Preference Flags Request Type
• The Settings State Request Type
• The Sequence ID Request Type
• The Window Position Request Type
• The Control Flags Request Type

Result Code

• Inside Macintosh defines a result code that an image compressor dialog function can return in the event of an error.

Data Types

Inside Macintosh defines the data types used with image compressor dialog component functions:

• SCModelFilterProcPtr
• SCModalHookProcPtr
• SCSpatialSettings
• SCTemporalSettings
• SCDataRateSettings
• SCExtendedProcs
• SCParams

Constants

Inside Macintosh defines the constants used with image compressor dialog component functions.